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WELCOME TO 
THE OFFICIAL 
RASPBERRY Pl 
BEGINNERS BOOK 


ou are holding, in your hands, a piece of history. 
The Official Raspberry Pi Beginner's Book isn't just 
a book about a computer: It's a book with a computer. 

Not just any computer either. The Pi Zero W is an 
incredibly well-designed microcomputer. And it's the most 
creative programmable computer on earth. 

With a Raspberry Pi, you can hack, make and build all 
kinds of different things. It could be a digital camera, ora 
retro games console, or a home media centre. Or a sensor on 
board the International Space Station, or a programmable 
Minecraft machine. 
Everything you need to get started with a Raspberry Pi 
computer is inside this kit. 

Our tutorials will guide you, step-by-step, from setting up 
the Pi Zero W hardware to learning how to use the Raspbian 
operating system, through to hacking electronics with the 
GPIO pins on your Pi Zero W. 

You'll also learn how to program a computer with Python, 
the world's best programming language. We show coding 
the fun way, by hacking worlds in Minecraft and making your 
own games. 

We're so glad you've got The Official Raspberry Pi 
Beginner's Book. Now let's get started... 


Lucy Hattersley 
Editor 
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Install the Raspbian OS with NOOBS 
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Use Etcher to install an image file 
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Adjust the settings in Raspbian 
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Create a home theatre system 
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Attach a camera to your Raspberry Pi 
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Work faster and smarter 
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Access the command line remotely 
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Control the pins on your Raspberry Pi 
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Save and share files on a home network 


GETTING STARTED WITH YOUR PI ZERO W 


D The Official Raspberry Pi Beginner's Book 


52 BUILD A WEB SERVER 
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The microSD card in your kit acts as the hard drive for 
your Raspberry Pi. You install the Raspbian operating n) = k 
system onto the card, then all your documents, a 1 S 
files, and projects are saved to it as you work. The 
microSD card in your Starter Kit is a high-quality piece 
of equipment and comes with NOOBS pre-installed. 

If you want to use a larger card, and are wondering 
which brand and type to get, take a look at the results 
from benchmark tests done by Raspberry Pi fan Jeff 


Geerling. Some cards run up to four times as fast as 
others. You can read more at magpi.cc/2bncFs3. 
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E Welcome to the Claws Mail setup wizard. 


We will begin by defining some basic information about you 
and your most common mail options so that you can start 


BLUETOOTH 


Devices connected 
by Bluetooth work 
wirelessly with your 
Raspberry Pi 


Start by putting your Bluetooth device 
in Pairing / Discoverable mode. We're 
using an Apple wireless keyboard 
here. Hold down the power button 
until the LED flashes. Click Bluetooth 
in the Panel and choose Add Device. 


Tum Off Bluetooth 


Make Discoverable 


The Add New Device window opens 
and will scan for nearby Bluetooth 
devices. Some will have names, 

others just identifying numbers (check 


on the device). Choose a device from 
the list and click Pair. 


Searching for Bluetooth devices. 
O 26952292275 
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Cancel 


The Pi now attempts to pair with the 
Bluetooth device. You'll be asked to 
enter a code on the keyboard; press 
the buttons and RETURN. You can 
now start using the Bluetooth device 
with your Raspberry Pi. 


Please confirm that device 'Lucy's MacBook Pro’ 
is showing the code 776706 to connect 


Cancel OK 
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The easiest way to set up a Raspberry Pi with Raspbian, 
and other operating systems, is to use the NOOBS installer 


micro SD card 
(8GB or larger) 


NOOBS 
installation fil A . i 
NEED VA Your starter kit micro SD card is already 


Mac, PC or set-up with NOOBS and ready to use 
Linux machine 


Click the Install button Connect to a wireless 
to format your micro SD network (or attach an Ethernet 
card and install the selected cable) to access a wider range 
operating system of operating systems 
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install () Edit config (e) Wifi networks (w) Online help (h) Exit (Esc) 
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PA fast and feature filled open source media center 


- (O Raspbian Lite 
A port of Debian Stretch for the Raspberry Pi (minimal version) 
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Options to expand the file system and change password 


Change Password... and hostname sit alongside various login choices. 
raspberrypi li 
: Support for the various hardware and software 
Boot: O To Desktop © To CLI features, such as Camera Module, SSH, and VNC. 
Auto Login: As current user ns 
Network at Boot: CJ Wait for network Overclocking and GPU memory options can improve 


the performance of a Raspberry Pi. 


Splash Screen: O Enabled ©) Disabled 


Set up an international keyboard, global WiFi options, 
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Build your home theatre media centre with a Raspberry Pi and OSMC 


uilding a media centre, or HTPC (home 
theatre PC) is one of the most rewarding 
projects a newcomer can complete. 
It's easy to turn a Raspberry Pi into an HTPC, and 
you can quickly hook it up to your television. 
Using an HTPC, you can play video and music files, 
and stream video and audio from online services. And 
unlike proprietary systems, such as Apple TV and 


Google Chromecast, you can use it to play just about 


any media format. 


You can add streaming services to your HTPC, such 
as BBC iPlayer and Soma radio stations. These enable 
you to play media directly from the internet. 

There are several pieces of software available for 
setting up an HTPC. Two options you'll find on the 


O Noos Hop? O 


Raspberry Pi Foundation’s Downloads page are OSMC 


and LibreELEC. Both are similar and run a media o A e 
7 is SELECT IMAGE SELECT DRIVE FLASH IMAGE 
player called Kodi. © o o 
In this guide, we're going to opt for OSMC. It's a 
€ E E " OSMC TGT .244mg.gr O Idevisdb - 7.9 GB on 
free and open-source media centre built on top of 


Debian, and is reliable and easy to use. 
Sett 
a straightforward and rewarding project. 


1g up OSMC on a Raspberry Pi is 3ETCHER 


Let's get started. 
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Remotely control your Pi from another computer with VNC Server and Viewer 
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By using the command line, you are able to work faster and smarter. 
Discover how to get started today... 
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pi@raspberrypi: 


raspberrypi 


~/Documents 


6 OCA + © Eros Ve à 5 « [i 7 
- pigraspbemypi ~ ex 
piéraspberrypi: ls -lah /home/pi/Documents/ 


total 20K 
drwxr-xr-x 5 pi | 4.0K 
drwxr-xr-x 31 pi pi 4.0K 
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drwxr-xr-x 11 | i 4.0K 
drwxr-xr-x 5 pi pi 4.0K 
drwxr-xr-x 2 pi i 4.0K 
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of a Unix file or directory 
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COMMAND 


Options 

Most commands have options that affect how they 
work. It's common to use these three options with 
the 1s command: 


ls -lah 


Options start with a single hyphen “— followed the 


letter for each option. The three options used here are: 


*] =long listing format 

«a = all including hidden files 

* h = human-readable (makes large file sizes 
more readable) 


Options are case-sensitive. Sols -landls -Lare 
two different things (small 1 is long listing format; 
large ‘L’ is dereference mode). Sometimes options are 
listed out in full. These start with two hyphens and 
have a single hyphen for spaces. This command is the 
same as ls -lah: 


ls -1 --all --human-readable 


But it's more common to see (and use) the single 
letter approach. 


Sudo 
Sudo stands for “substitute user do”, although it's 
often also called “superuser do”. If you have multiple 
users on your system, it can be used to perform 
commands as another user. 

It's mostly used to get root access to your Linux 
installation. There is an account that controls your 
Pi user, called “root”. This is an all-powerful account, 


which can change just about anything on your system. 


Your default account can view files in the root of 
the hard drive, but it can't create or delete files at 
the root. Enter: 


cd / 
touch test.txt 


You'll see touch: cannot touch “test.txt?: 
Permission denied. However, enter: 


sudo touch test.txt 
… and the test.txt file will be created on the root of 
your hard drive. You can see it using Is -1. 

Now try to delete it: 

rm test.txt 

It will say rm: remove write-protected regular 
empty file ‘test.txt’?” Enter Y and it'll say rm: 


cannot remove ‘test.txt’: Permission denied. 
You need to use sudo to remove the file: 


raspberrypi.org/magpi 


sudo rm test.txt 


You can see why sudo is such a powerful tool. 
Without it, you couldn't install software using apt 
or apt-get. But with it, you can remove or delete vital 
system files. Enter ls /bin and you'll see many 
programs (known as “binaries”) used by Linux. These 
include the 1s command you just used. Accidentally 
deleting these files could make your system unstable. 

So use sudo with care. In Raspbian you don't need to 
enter the password to use sudo. On many other Linux 
systems, however, you will be asked for the password 
before you can use sudo. 


What's up, man? 

There are lots of ways of getting help inside the 
command line. The first command you should turn 
to is man. This stands for “manual” and gives you 
instructions on Linux commands and tools. Enter: 


man ls 


...and you'll see the manual for the list command. 
Notice under the SYNOPSIS it says: 


ls [OPTION]... [FILE]... 


This shows you the structure of the command. 
Almost all commands are in the 'command, option, 
argument' structure, although some arguments have 
more than one [FILE] argument (such as copy, which 
requires a source and destination file). 

Press the space bar to move down the instructions. 
Here you will see a list of all the available options. 
With man, you can get detailed information on just 
about every tool on the command line. You can even 
get a manual for the man command with: 


man man 


If you need a quick reminder on how to use a 
command, try using it with -h or - -help as an option: 


touch --help 


...tells you what options are available with the touch 
command. You can use this with many command-line 
tools to get a quick refresher on how they work. 

Moving from a GUI to a command line is a vital skill for 
hackers and coders. Everything on your computer, from 
programs to preferences, is stored in the file system 
somewhere. Learning to use the command line makes 
you a more capable Raspberry Pi user. 

So, the next time you make a file, move a file, or 
delete something, don't head to the File Manager. 
Open Terminal and perform tasks from the 
command line. Soon it'll be second nature. 
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Terminal 


Ro 


[x] pi@raspberrypi: ~ 
l M »k:-S ssh pi@192.168.0.19 


The authenticity of host '192.168.0.19 (192.168.0.19)' can't be established. 
ECDSA key fingerprint is SHA256:k2RP2BuKYuu1uF79n1WT8Sv46ZGLF3mg3ryH4z0/0SE. 


Are you sure you want to continue connecting (yes/no)? yes 


Warning: Permanently added '192.168.0.19' (ECDSA) to the list of known hosts. 


pi@192.168.0.19's password: 


The programs included with the Debian GNU/Linux system are free software; 


the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent 
permitted applicable law 

Last logi Tue Dec 6 10:14:12 2016 from 192.168.0.38 
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Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 


OK 


raspbemypi: ~ 


000 lucy@lucy-MacBook: 

lucyglucy-MacB. $ ssh pig192.168.0.19 

The authenticity of host '192.168.0.19 (192.168.0.19)' can't be established. 

ECDSA key fingerprint is SHA256:k2RP2BuKYuu1uF79n1WNT8Sv«6ZGLF3mg3r yH4zO/oSE. 
adi Are you sure you want to continue connecting (yes/no)? yes] 
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Category 
J- Session Basic options for your PuTTY session 
E — Specify the destination you want to connect to 
= eminai 
( ) 
Keyboard Host Name (or IP address) Port 
Bell 192.168.0.19 22 
Features Connection type _ 
Window (Raw (Telnet O) Rlogin SSH Serial 
Appearance 
so Load. save or delete a stored session 
Behaviour 
Translation Saved Sessions 
Selection 
Colours Default Settings Load 
=} Connection 
Data Save 
Proxy 
Telnet Delete 
Rlogin 
+) SSH 
l 
orn Close window on exit 
O Always (©) Never Only on clean exit 
About Open Cancel 
- n 


BP piOraspberrypi ~ 


& piOraspberrypi: ~ 


Discover the easy way to control GPIO pins on your Raspberry Pi 


All Models 
3v3 5V 
Power 1 2 Power 
GPIO2 "s a M 5v 
SDA lC EM Power 
GPIO3 O Ground 
SCL PC y 
GPIO4 (8) GPIO14 
UARTO TXD 
Ground O (10) GPIO15 
UARTO RXD 
GPIO17 010 GPIO18 
GPIO27 (3) © Ground 
GPIO22 010, GPIO23 
EJ GPIO24 
ower 
GPIO10 (19) o Ground 
SPI MOSI 
GPIO9 GPIO25 
SPI MISO 
GPIO11 (24) GPIO8 
SPI SCLK SPI CEO 
Ground o (26) GPIO7 
SPI CE1 
ID SD ID SC 
4 FC ID 27 28 PC ID 
GPIO5 o Ground 
GPIOG DO GPIO12 
GPIO13 Es) o Ground 
GPIO19 910) GPIO16 
4 GPIO26 (DO) GPIO20 
Ground © GP1021 
40-pin 
models only 
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danguage 


>PYTHON 


DOWNLOAD: 
button i py magpi.cc/2ehTqVq 


from gpiozero import LED, Button 
from signal import pause 


led - LED(17) 
button - Button(21) 


button.when pressed - led.on 
button.when released - led.off 


pause() 


traffic lights.py 


from gpiozero import LED 
from time import sleep 


red - LED(25) 
amber = LED(8) 
green - LED(7) 


green.on() 
amber.off() 
red.off() 


while True: 


>STEP-07 sleep(10) 


Adding a button green.off() 
Now we're going to add a button to our circuit and amber .on() 
connect it to GPIO21 with an LED wired up to GPIO17. sleep(1) 
Buttons are wired up in a similar fashion to LEDs, amber.off() 
using female-to-male jumper leads. red.on() 
Like LEDs, buttons have legs. One leg is wired to a sleep(10) 
GND pin (via the same ground rail you've been using amber.on() 
for LEDs); the other leg is connected to a GPIO pin. sleep(1) 
Some buttons have four legs, so you can connect green.on() 
them to the breadboard with their legs straddling amber .off() 
the central groove (see the breadboard diagram). red.off() 


>STEP-08 


Button responder 5 
Unlike LEDs, you don't need to use a resistor with a Going further MådPi 


button. The button's legs are the same length, and it 


typically doesn't matter which way around you hook You can achieve a lot more with GPIO Zero than SIN MAPLE 
it up to the breadboard. controlling LEDs and buttons. perd "x 
ELECTRONICS 

When the button is pushed, it forms a connection For a more detailed look at how you can detect WITH 

between the ground rail and the pin, completinga motion, control robots, read sensor information črto ZERO 

circuit. The Raspberry Pi is set up, using GPIO Zero, (such as movement sensors or thermometers), = $i 

to detect this connection and respond. The MagPi's Phil King has created a fantastic guide: = | d 
Open Python shell and create a new file. Enter the MagpPi Essentials: Simple Electronics with GPIO Zero. 

code from button.py, save the file, and run the code. Learn more at magpi.cc/Back-issues. 

When you push the button, the LED will light up. 
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This humble plastic block full of holes can be used to create just about anyihing 
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Tutorial | RASPBERRY PI 101: CODE IN PYTHON WITH THONNY 


Use the new Thonny IDE to understand what's going on in your code 


» Raspberry Pi 


Latest version 
of Raspbian 


> Thonny 


mj m 


print("Hello World")| 


cl 

Python 3.4.2 

>>> Run hello.py 
Hello World! 


>>> name = "Lucy" 
File Edit View Run Tools Help >>> print(*Hello " + name) 


Ci mu Lo gp fà é o Hello Lucy 


class Animal(): 
def init (self, c, n): 
selr.creature = c 


You can see the values self.neme = n 
stored in your variables as 


turn seif.creature 
you run the program ns - 


f get name(self): 
return self.nane 


am in thi p left of the scre anc 
" o 
animals .append( Animal ( "Mouse", "Nibbles") ) 


t nase() 


In debug mode, Thonny "get creature() ncrease Font Size so y can 


highlights code and runs it one step at EMI) 
a time, so you can see what each code xt 
element is doing 1 


The Heap window displays the NG 
memory addresses of objects, functions, 
and other elements of your program 1 p am hello.py. Click "Ru: 
Clam is a Car ; E» SEP) RES EEN 
Wibbles is s Mouse e] pt (O K 'D) to 
>> “Debug animals.py + Jun ts 
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a= 19 


while n » 0: 
printin) 
ne«1 


print(*Blast Off! 


n* 10 


While n 8 
printin) 
n=l 


print("Btast Off!*) 


a= 10 

faite TAWA 
print(n) 
n--l 


n=3 


def count(n) 
ifn» 


print(n) 
count(n-1) 


print("Blast off!") 


&ount(3) 


def count(n) 
if n» 6 
print(n) 
count(n-1) 


print(*Blast off!") 


animals.py 


class Animal(): 
definite Ses ME 
.creature [s 


. name n 
def get creature( JE 
.creature 


def get_name( JA 


. name 

animals [] 

animals.append(Animal( 5 )) 

animals.append(Animal( 5 ) 

animals.append(Animal( 5 )) 
animal animals: 


name = animal.get name() 
creature = animal.get creature() 
print(name creature) 


countdown. recursion.py 


n 
def count(n): 
n : 
print(n) 
count(n-1) 


printi ) 


count(n) 


counidown.py 


n 
print(n) 
n 


print( ) 


RASPBERRY PI 101: SET UP A FILE SERVER 


Turn your Raspberry Pi into a file server to back up and share content 
from anywhere on your local network 


A 32GB micro and supported by media streamers, game th the R berry P 
SD card 


Raspberry Pi 2/3 


» Monitor, E E monitor to setu our fi server, but OU network, and us ta ynvenient pl 
keyboard and ; ativel able r aepi.cc/AGULmTE) 

mouse (for Di 

setup) 


Wired Ethernet 
connection 


> NOOBS 
magpi.cc/ : E É ; > à 3 
2bnfsXF as . However, | UN extra storage, it's eas ill st rk if vou conne 


File Edit Search Options Help 


# printer drivers 
[print$] 
comment = Printer Drivers 
path < /var/lib/samba/printers 
browseable = yes 
read only < yes 
guest ok < no 
# Uncomment to allow remote administration of Windows print drivers. 
# You may need to replace 'lpadmin' with the name of the group your 
# admin users are members of. 
# Please note that you also need to set appropriate Unix permissions 
# to the drivers directory for these users to have write rights in it 
; write list = root, Olpadmin 


An entry in /etc/samba/ 
smb.conf will create the top-level 
directory of your share 


[share] m This is the location of the 
comment < Pi shared folder folder we're going to share 
path = /share = Saas 


browseable = yes 
writeable = yes 

only guest = no 
create mask = 0777 
directory mask = 0777 
public = yes 
guest ok = yes 


We've enabled guest access, so 
network users won't need a username 
and password to access the share 
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453721581. 


F Ubranes 


Documents 


SU Metro 


RASPBERRY PI 101: BUILD AN INTRANET WEB SERVER 


Build a local HTML server with Apache 


Raspberry Pi 2/3 


Monitor, 
keyboard, and 
mouse (for setup) 


Wired Ethernet 
connection 


micro SD card 
with NOOBS 
magpi.cc/ 
2bnf5XF 


€ > C 0 192168178167 


Bv . 0 a 


insta Ap cont to) Wifi networks (w) Online help (h) sit Ee) 


C pbian [RECOMMENDED] a 
port of Debian jessie for the Raspberry P (full desktop version) 


283 Lol M—— E 
p (O A pa o Dean jessie for the Raspberry P (minimal version) # 
QE em ce # 
a [=| Alika on empty 51208 edd format partion te the partion layout. # 


Ors 
À fast and feature filed open source media center 


HE apps D france D personal Phones |] Umax [ll telephony D] food D) technical Di history || networking D) windows 1) vmesne D Wien |. places [I Reportage 


The Custard Conundrum 


This is the address 
of your new website 


TV ang movies [7] Funny M) hardware Di Cart D games [led D vintage computing M blogs D poety 


Your site's title, like its 
structure, is defined in the HTML 
code of the pages you upload to it 


Your new website 
(custard optional) 


— The Official Raspberry Pi Beginner's Book 


= = me am à him E 
ORINA E = ——— —— 


debian 


locumented 


doc/apache2/README.Debian.gz. À 


High Contrast Cats 


Back up the files on a Raspberry Pi so you can quickly restore your files 


Raspberry Pi 
SD card 


Flash drive À 


Files backed up using Déjà Dup are | 
restored using the same program 


Adding a password to your backup can secure the | Deja Dup is a popular program | 
files stored remotely (or on an external drive) used to schedule backups | 


Require Password? =y Lt backup iras toda 
- s B Folders to save fæl You can restore the entire backup with the Restore... button or use Files to either 
O Allow restoring without a password : revert individual files ol restore missing ones. 
(2) Password-protect your backup Folders to ignore 
+ estore. 
You will need your password to restore your files. Storage location 
You might want to wnte it down. 


cid No backup scheduled. 


You should enable automatic backups or use the Back Up Now... button to start one now. 


Back Up Now. 


Encryption password | «se 
comme [=] 


© Show password 
© Remember password 


Cancel Continue 
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$ Win32 Disk Imager 


>= You can clone you 
dd on a Mac or Linux, and Win32 D 


raspberrypi.org/magpi 


ms | o 


Folders to save fæl vou may use the Restore... button to browse for existing backups. 


Folders toignre [reso] cia 
Storage location 
Scheduling No backup scheduled. 


You should enable automatic backups or use the Back Up Now... button to start one now. 
Lek un on) 


Above: os 
can be restored 
individually, or 


You PSA 


V EN 


Don't let your Raspberry Pi suffer from a shortage of volts 


POWER YOUR RASPBERRY Pl 


Max 0.26A 


0.40A 0.75A 0.20A 


Avg 0.22A 0.22A 0.35A 0.15A 
Idle Avg 0.204 0.224 0.3a0A 0.10A 
Video playback (H.264) Max 0.30A 0.36A 0.55A 0.23A 
Avg 0.22A 0.28A 0.33A 0.16A 
Stress Max 0.35A 0.82A 1.34A 0.35A 
Avg 0.32A 0.75A 0.85A 0.23A 


Test conditions used a standard Raspbian image (26 Feb 2016), at room 
temperature, connected to an HDMI monitor, USB keyboard, and mouse. 

For the Model 3B it was connected to a WiFi access point. All these power 
measurements do not take into account power consumption from additional 
USB devices; these measurements can easily be exceeded with multiple 
additional USB devices connected or when using a HAT. 


lous 


peripheral curt 


Raspberry Pi Model A 700mA 500mA 200mA 
Raspberry Pi Model B 12A 500mA 500mA 
Raspberry Pi Model A* 700mA 500mA 180mA 
Raspberry Pi Model B* 18A 600mA/1.2A (switchable) 330mA 
Raspberry Pi 2 Model B 18A 600mA/1.2A (switchable) 350mA 
Raspberry Pi 3 Model B 2.5A 12A -400mA 
Pi Zero / Pi Zero W 12A 12A 200mA 


cial Raspberry Pi Beginner's Book eS 


The basic commands you need to get advice from the Linux command line 


OCA O Elo $ Wu 


Many commands 
featurea built- 

in help option, 
accessed with -h 

or - -help. Using it 
offers a brief outline 


| 
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Get off to a good start with Minecraft: Pi Edition. 
Play the game and write your first program using the API. 


The mouse changes where you look 

Holding the left button destroys blocks 

Right button places blocks 

W, S, A, D move you forward, backward, left, 
and right 

1,2,3,4,5, 6, 7, 8 change what you are holding 
E opens the inventory 

ESC takes you back and to the Menu 

SPACE is jump. Double-tapping it makes you fly 
or stop flying 


ella Minecraft Hor La 


Get the player's position 

Change (or set) the player's position 

Discover the type of block at a specific location 
Change a block 

Change the camera angle 

Post messages to the player 


Go to the Minecraft menu with ESC, but leave 
the game running (you can minimise it). 
Open IDLE by clicking Menu > Programming > 
Python 3 (IDLE). 
Use File » New File to create a new program and 
save it as hellominecraftworld.py. 

At the top of your program, type the following 
code to import the minecraft module, which 
will allow you to use the API and talk to the game: 
import mcpi.minecraft as minecraft 

On the next line, create a connection from your 
program to Minecraft and call it mc: 

mc - minecraft.Minecraft.create() 

Use your Minecraft connection and the 
function postToChat() to put a message in 
the chat window on a third line: 
mc.postToChat("Hello Minecraft World") 
Run your program by clicking Run » Run Module. 


— 


All blocks in 
Minecraft have a 
position of X, Y, Z 


WATCH FOR 
RED TEXT 


PYTHON 


IS CASE- 
SENSITIVE 


Teleport the player by setting their position: 
mc.player.setPos(0, 50, 0) 

Run your program by clicking Run > Run Module. 
Quickly switch back to Minecraft to see your 
player fall to the floor (unless in flying mode). 


If you've completed the Minecraft Pi learning resources at 
raspberrypi.org, check out these pro tips and mini programs 
to learn more about the coding in Minecraft... 


Create massive 
houses in the blink of 
an eye using just a few 
lines of code 


Magi 
HACKING aw 
MAKING 


"MINECRAFT 
CODE VIRTUAL WORLDS 


vo Raspberry Pi 


i r^ e. T 
P rr 
A QS | 
=, LANA 


- 


CHANGE THE CAMERA 


Bored of always following Steve around? You can alter 
the position of the “camera” in Minecraft to change how 
you see the world. 

You can change the camera to follow Steve while 
looking directly down at him, or to look down at the 
world from any coordinate in Minecraft. 

The camera. setFollow() function will change your 
view so you are looking down at Steve. In a new script: 


from mcpi import Minecraft 
mc = minecraft.Minecraft.create() 


mc.camera.setFollow() 


To change the camera to look down on any position, 
you use the camera.setFixed() function before using 
camera.setPos() to change the position of the camera. 
If you wanted to set the camera 25 blocks above the 
spawn position, you would use: 


mc.camera.setFixed() 
mc.camera.setPos(0,25,0) 


To set the camera back to normal, you would 
use the camera. setNormal() function. 
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mc.camera.setNormal() 


Using the camera functions, you could hide a 
diamond block (57) in the world, then tease the 
player by changing the camera to show them where 
it is before challenging them to find it. Try this ina 
new program: 


from mcpi import minecraft 
from time import sleep 
mc - minecraft.Minecraft.create() 


mc.postToChat("Here is the zlu, 
block I have hidden.") 
mc.setBlock(100,25,100,57) 
mc.camera.setFixed() 
mc.camera.setPos(100,30,100) 
sleep(10) 


mc.postToChat("Go find it!") 
mc.camera.setNormal() 


You could change the program above to drop 
the diamond block in a random position and use 
getHeight() so the diamond block is always on the 
top of the world. 
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mcpi minecraft 
mc - minecraft.Minecraft.create() 


#make the world read-only 
mc.setting( , True) 


#make the world writable 


mc.setting( , False) 
mcpi minecraft 
time sleep 


mc - minecraft.Minecraft.create() 
mc.setting( , True) 
mc.postToChat( 


sleep(10) 
mc .postToChat( ) 


mc.setting( , False) 
sleep(60) 
mc .postToChat ( 

) 


mc.setting( , True) 


Have you exhausted the Minecraft: Pi basics available from raspberrypi. 
org/resources? Have you completed our Minecraft Pi coding tips? Here 
are another five tips and mini-programs to experiment with... 


cd -/.minecraft/games/com.mojang/minecraftWorlds 
ls 


- czf world--backup.tar.gz world-- 


world--backup.tar.gz 


tar xzf world--backup.tar.gz 
pi@rpi2 


Minecraft - Pi edition 


B, 48.2, 24.3 


mcpi minecraft 
mcpi block 


mc - minecraft.Minecraft.create() 


pos - mc.player.getTilePos() 


mc.setBlock(pos.x, pos.y 2, pos.z, block.STONE) 


# create torches 

# on top 

mc.setBlock(pos.x, pos.y j, pos.z, block.TORCH) 

# to the east 

mc.setBlock(pos.x 1, pos.y 2, pos.z, block.TORCH) 
# to the west 

mc.setBlock(pos.x 1, pos.y 2, pos.z, block.TORCH) 
# to the north 

mc.setBlock(pos.x, pos.y 2, pos.z 1, block.TORCH) 
# to the south 

mc.setBlock(pos.x, pos.y 2, pos.z 1, block.TORCH) 


mcpi minecraft 


minecraft.Minecraft.create() 


mc.saveCheckpoint() 


mc.restoreCheckpoint() 


mcpi minecraft 
time sleep 


minecraft.Minecraft.create() 


#every 30 secs save a checkpoint 
count 
mc.saveCheckpoint() 
mc.postToChat("Checkpoint saved") 
count 
sleep(1) 


Hif a block is hit, restore checkpoint 
mc.events.pollBlockHits(): 
mc.restoreCheckpoint() 
mc.postToChat("Restoring 
checkpoint") 


USA A ISI 


^ ms 
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MINECRAFT: PI | Tutorial 


CALCULATING THE DISTANCE 
BETWEEN TWO BLOCKS 


When coding Minecraft, it's really useful to know the 
distance between two blocks - and by using some 
(fairly) simple maths, we can work it out. This can 
be used in loads of fun ways, such as a hide and seek 
game where a diamond block is hidden and Steve is 
told whether he is getting colder or warmer. 

The maths works like this: 


01 Calculate the difference between the x, y 
& z coordinates of the two positions 


02) Multiply the difference by itself (its square) 
03 Add all the sguares together 


04 The distance eguals the sguare root 
of the total above 


This program uses this calculation to display how 
far the player is from where they started. So the 
further they move away, the greater the distance. See 
how it works by copying the following code example 
into IDLE or your favourite text editor (don't forget to 
save it with the .py file extension): 
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from mcpi import minecraft 
from math import sqrt 
from time import sleep 


mc - minecraft.Minecraft.create() 
startPos - mc.player.getTilePos() 
while True: 
posNow - mc.player.getTilePos() 
xDiff = startPos.x - posNow.x 
yDiff - startPos.y - posNow.y 
zDiff - startPos.z - posNow.z 
xSquare - xDiff * xDiff 
ySquare - yDiff * yDiff 
zSquare - zDiff * zDiff 
total = xSguare + ySquare + zSquare 
distance - sqrt(total) 
mc.postToChat(distance) 
sleep(1) 


Try changing the program to show the distance between 
the player and a random diamond block you have created. 
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A earning to code is one of the most profoundly 

L ] life-changing things you can do. This has 

always been true, but learning to code is 
increasingly important in the modern world. 

The reason the Raspberry Pi was created was to 
challenge a drop in computer science applications 
at Cambridge University. Modern computers, and 
especially games consoles, were fun and powerful, 

but not easily programmable. 
The maker community fell in love with the 

Raspberry Pi, thanks to its cheap and hackable 
nature. Building and tinkering are the primary 
reasons we love Raspberry Pi. Great projects use a 
combination of hardware and software together. 

So, whether you're a hacker learning to make 
better projects, or a would-be coder looking for 
a better career, this feature is set to help you on 
your way. 

The good news is that you don't need to be a genius 
to know coding, just as you don't have to be a genius 
to read and write. It's actually pretty simple once you 
learn a few simple concepts like variables, branching, 
and loops. 

Perhaps you're brand-new to coding. Maybe you 
did a little BASIC in school, or used old languages like 
Pascal and Fortran. Or maybe you're already knee- 
deep in projects and just want to learn the language 
that controls them. 

Wherever you're coming from, we're here to 
walk you through the basic concepts of computer 
programming. We'll demystify the whole process of 
code, so you can get a better understanding of what's 
going on inside your Raspberry Pi. 
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Code Matters 


“| think everybody in this country should learn to program a 
computer," said Apple's co-founder Steve Jobs, "because it 
teaches you how to think." 

Code is a critical layer in our lives that sits between us 
and the increasingly digital world that surrounds us. With 
just a small amount of understanding how code works, 
you'll be able to perform computer tasks faster and get a 
better understanding of the world around you. Increasingly, 
humans and machines are working together. 

Learning to use code and hardware is incredibly 
empowering. Computers are really about humanity; it's 
about helping people by using technology. Whether it's the 
home-made ophthalmoscope saving eyesight in India, or 
the Computer Aid Connect taking the internet to rural Africa, 
code on the Raspberry Pi is making a real difference. 

Coding also makes you more creative. It enables you to 
automate a whole bunch of boring and repetitive tasks in 
your life, freeing you up to concentrate on the fun stuff. 

It also teaches you how to solve problems in your life. 
Learning to how to put things in order, and how to break 
down a big, seemingly impossible task into several small 
but achievable tasks is profoundly life-changing. 

And if you're looking for a career boost, there's plenty of 
worse things to learn. "Our policy is literally to hire as many 
engineers as we can find," says Mark Zuckerberg, CEO 
of Facebook. "The whole limit in the system is that there 
just aren't enough people who are trained to have these 
skills today." 
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Python 2 and 
Python 3 are both 
commonly used. 
Python 3 is the 
future, so we're 
going with it. Lots 
of courses still teach 
Python 2, and it's 
not a bad idea to 
take a closer look 
atthe differences 
between the two: 
magpi.cc/2gP6zX3 


Python is an 'interpreted language: 
You write the code and then run the 
program. Under the hood, it's being 
translated and runs on the fly. Some 
languages, such as C and Java, are 
compiled. You write the program, then 
compile it to get a build file (written in 
machine code), then you run the build. 
It's a faff you can do without for now. 


r 


Discover the building blocks of software 
O and learn what goes on insidea program 


efore you go any further, let's look at what a 

program actually is. The dictionary definition 

is a "set of instructions that makes a 
computer do a particular thing." 

A computer program is a lot like a recipe. It has 
a list of ingredients, called ‘variables’, and a list of 
instructions, known as “statements” or “functions”. 
You follow the instructions from the recipe one line at 
atime and end up with a tasty cake - and that's no lie. 

The real miracle of computers, however, is that 
they can do the same thing repeatedly. So you can 
get a machine to bake a thousand cakes without ever 
getting tired. A program may contain loops that make 
it do the same thing over and over again. 

Programs also make decisions, and different paths 
through a program can be taken. Your recipe could 
make a scrummy chocolate cake or a delightful 
batch of doughnuts, depending on the variables (the 
ingredients) it has. 
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One thing that may surprise you when you begin 
programming is just how little you need to know to 
get started. With just a few variables, a smattering 
of flow, and some functions, you can get a computer 
doing all the hard work for you. 


Inside your Pi 

At the heart of your Raspberry Pi are billions of voltage 
switches known as binary digits (or “bits” for short). 
There are 8,589,934,592 of them in its 1GB of RAM, to 
be exact. All these switches can be set to high or low, 
which is typically represented as O (for low or off) and 
1(for high or on). Everything you see on the screen, 
hear from the speakers, and type on the keyboard is 
billions of switches being turned on and off. 

Obviously, it's not that easy for humans to talk 
directly to computers. It's possible to use machine 
language and send binary instructions directly to a 
computer, but this isn't where any sane person starts 
(or ends if they want to remain sane). 

Instead, we use a coding language to program. This 
is written using easy-to-understand functions like 
print(). These are then interpreted into machine 
language, which the computer understands. 

We're going to use Python to learn to code. Python 
is a truly great programming language. It has a rich 
syntax that's free from clutter; you don't have to 
worry about things like curly braces and static typing 
that crop up in more complicated languages like Java. 

With Python, you can just create code, run it, and get 
things done. Python is one of the languages found most 
commonly on The Raspberry Pi, so learning it here will 
help you understand lots of the code used in projects. 
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IDE and IDLE 


You don't have to write Python programs using a text 
editor like Leafpad and run them in the terminal. 
Instead, you can use a neat all-in-one solution, known 
as an “IDE” (integrated development environment). 

IDEs combine a text editor with program-running 
functionality. Often, they'll include fancy features like 
debugging and text completion. 

Click Menu > Programming > Python 3 (IDLE), and 
you'll get a new window called ‘Python 3.4.2 Shell”. 
This Shell works just like Python on the command line. 
Enter print("Hello World") to see the message. 

You can also create programs ina built-in file 
editor. Choose File > New File. Enter this program 
in the window marked 'Untitled': 


word1 = "Hello " 
word2 - "World" 
print(word1 + word2) 
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Above Python IDLE makes it easy to create programs and 
run them without having to use the command line 
Don't forget to include the space after “Hello”. Choose 
File » Save As and save it as hello.py. Now press F5 on 
your keyboard to run the program. (Or choose Run > 
Run Module). It’! display ‘Hello World’ in the Shell. 
The advantage of using Python IDLE is that you can 
inspect the program in the Shell. Enter word1, and 
you'll see “Hello”. Enter word2 and you'll see “World”. 
This ability to inspect and use the variables in your 
program makes it a lot easier to experiment with 
programming and detect bugs (problems in your code). 


Python comes 
pre-installed in the 
Raspbian operating 
system and you 
can use it at the 
command line 


The Official Raspberry Pi Begainner's Book 3 75 


Variables are all-purpose containers that you use to store data and objects 


Python has five 
standard data types: 
e Number 

e String 

e List 

e Tuple 

e Dictionary 


You'll come 
across 'foo' and 
‘bar’ a lot when 
learning to code. 
These are dummy 
placeholders and 


don't mean anything. 


They could be zig 
and zag or bim and 
bam. Nobody's 
quite sure, but it 
might be related 
to the expression 
'fubar' from the 


Vietnamese war. 


f you've created a science project or 

experiment, you may have come across 

variables. In science, a variable is any factor 
that you can control, change or measure. 

In computer programming, variables are used to store 
things in your program. They could be names, numbers, 
labels, and tags: all the stuff your program needs. 

In Python, you write the name of a variable then a 
single equals sign and the word, number or object you 
want to put in it. 

Enter this code directly into the Shell: 


foo = 1 
bar = 2 


Remember: the variable name is on the left, and the 
thing it contains is on the right. Imagine you've got 
two plastic cups, and you've scrawled ‘foo’ on the first 
and “bar' on the second. You put a number 1 in foo and 
a number 2 in bar. 

If you ever want to get the number again, you just 
look in the cup. You do this in Python by just using the 
variable name: 


foo 
bar 


You can also print out variables by passing them 
into a print function: 


print(foo) 
print(bar) 
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Variables can also be used to contain “strings”. 
These are groups of letters (and other characters) 
that form words, phrases or other text. 

Creating a string variable in Python is pretty 
much the same as creating an integer, except 
you surround the text with single(' ') or double 
(" ")quotes. 

Using double quotes makes it easier to include 
apostrophes, such as print("Don?t worry. Be 
Happy"). This line would break after “Don” if you used 
single quotes - print('Don?t worry, be happy') 
- so use double quotes for now. 


Why variables count 

Variables make it much easier to change parts of your 
code. Say you've got an excellent coding job at Nursery 
Rhymes Inc and you've written a classic: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We?ll all have tea") 


The head of marketing comes in and says “our data 
shows that Polly isn't trending with the millennial 
demographic." You say “Huh!” and he barks “Change 
Polly to Dolly.? 

You now have to go through and change the variable 
in all three lines. What a downer! But what if you'd 
written thousands of lines of code and they all needed 
to change? You'd be there all week. 

With variables, you define the variable once and 
then use it in your code. Then it's ready for changing 
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atany time: 
name = "Polly" 


print(name + " put the kettle on) 
print(name + " put the kettle on) 
print(name + " put the kettle on) 
print("We?ll all have tea") 


This code prints out the same classic nursery rhyme. 


But if you want to change the name of our character, 
you only have to change it in one place: 


name - "Dolly" 


...and the poem will update on every line. 


What's your type? 

When you create a variable in Python, it's 
automatically assigned a type based on what it is. You 
can check this using the type() function. In the shell 
interface, enter: 


foo = "Ten 
bar 


UI 
H 
© 


Now use the type() function to check the type of 
each variable: 


type(foo) 
type(bar) 


It will say «class 'str'» for foo, and «class 
'int'» for bar. This concept is important, because 
different types work together in a variety of ways, and 
they don't always play nicely together. 

For example, if you add together two strings they 
are combined: 


name - "Harry" 
job = "Wizard" 
print("Yer a " 


+ job + + name) 

This prints the message “Yer a Wizard Harry”. The 
strings are concatenated (that's a fancy programming 
term for “joined up”). Numbers, though, work 
completely differently. Let's try a bit of maths: 


6 
9 


number1 
number2 


print(number1 + number2) 
Instead of concatenating 6 and 9 together to give 


69, Python performs a bit of maths, and you get the 
answer ‘15’. 
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Type casting 
So what happens when you want to add a string and 
an integer together? 


What 
lo calla 
variable? 


Variable names 


name - "Ben" 

number - 10 

print(name + number) 
should be lower- 


case words 
separated by an 
underscore '_. 


You'll get an error message: ‘TypeError: Can't 
convert 'int' object to str implicitly. This error is 
because Python can't add together a string and an 
integer, because they work differently. Ah, but not 
so fast! You can multiply strings and integers: 


They can include 
numbers, but 
must start with a 
letter. You can call 
variables pretty 
much anything, 
but there's a small 


print(name * number) 


It'll print ‘Ben’ ten times: you'll get 
*BenBenBenBenBenBenBenBenBenBen'. 

If you want to print out ‘Ben10’, you'll need to 
convert the integer to a string. You do this using 
a str() function and putting the integer inside 
the brackets. Here we do that, and store the result 
in a new variable called number as string: 


list of reserved 
keywords you 
should avoid 
(magpi.cc/ 
2h7MH1y). It's a 
good idea to call 
them something 
that will be 
obvious when 
you use them in 
your program, like 
'student name' or 
'person.age. 


number as string - str(number) 
print(name + number as string) 


This code will print out the name 'Ben10'. This 
concept is known as 'type casting': converting a 
variable from one type to another. 

You can also cast strings into integers using the 
int() function. This is particularly useful when you 
use input() to get a number from the user; the input is 
stored as a string. Let's create a program that asks for 
a number and exponent and raises the number to the 
power of the exponent (using the ***” symbol): 


number - input("Enter a number: ") 
exponent - input("Enter an exponent: ") 
result - int(number) ** int(exponent) 


SANA 


Our first two variables, number and exponent, e 
are strings, while our third, result, is an integer. | 
We could just print out the result: 


print(result) 


But if we wanted to include a message, we need to 
type cast result to a string: 


print(number + 


raised to the power 
+ exponent + " is " + str(result)) 


Variables, types, and type casting can be a bit tricky at 
first. Python is a lot easier to use because it dynamically 
changes the type of a variable to match the thing you put 
in it. However, it does mean you have to be a bit careful. 
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Teature 


IDE TO 
CODING 


omputers are great because they don't mind 
doing the same stuff over and over again. 
Their hard-working nature makes computers 
ideal for doing grunt work. 
When looking at variables earlier, we printed out 


Then we use the while statement followed by a 
condition: counter « 3. 

On the next line down, you press the space bar four 
times to indent the code. Don't press the TAB key 
(see “Tabs or spaces? boxout). 


These comparison this nursery rhyme: 


operators are while counter « 3: 
print(name + " put the kettle on") 


counter = counter + 1 


commonly used print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 


print("We?ll all have tea") 


in conditions 

to determine if 
something is True 
or False: 


The < symbol stands for “less than”. 
It checks if the item on the left is less than the 


equal 

not equal 
less than 
less than 

or equal to 
greater than 
greater than 
or equal to 
less than or 
greater than 


We didn't like the repetition of Polly, so we replaced it 
with a variable. But this code is foolish in another way: 
you have to write out the same print line three times. 

We're going to use a loop to get rid of the repetition. 
The first loop we're going to look at is a “while loop”. 
In Python 3 IDLE, create a new file and save it as 
polly.py; enter the code from the top of the next page. 

We start with two variables: 


name - "Polly" 
counter - 0 


There's a massive nerd debate about whether to use spaces or tabs when 
indenting code. There are valid arguments on both sides, which you can learn in 
this clip from HBO's comedy Silicon Valley (magpi.cc/2gZdeoM). Use spaces for 
now. When you're a hardcore coder, you can make the argument for tabs. 
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item on the right. In this case, it sees if the variable 
counter (which starts at 0) is less than 3. This 
condition is known as ‘True’; if it wasn’t, it'd 
be known as ‘False’. 

Finally, enter the last line of code: 


print("We?ll all have tea") 


Save and run the program (press F5). It will print 
“Polly put the kettle on’ three times and then “We'll all 
have tea”. 


While, condition and indent 
There are three things here: the while statement, the 
condition, and the indented text, organised like this: 


while condition: 
indent 


Imagine a three-way chat between all three items 
in our polly.py program: 
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While: “Hey Condition! What's your status?” 
Condition: “True! The counter is O. It's less than 3.” 
Indent: “OK, guys. I'll print out “Polly put the kettle 
on' and increase the counter by 1. What's next?" 


While: “Hey Condition. What's your status?” 
Condition: “True! The counter is now 1.” 
Indent: “OK. I’m printing out another ‘Polly put 
the kettle on' and increasing the counter by 1." 


This goes on till the counter hits 3. 


While: “Hey Condition. What's your status?” 
Condition: “False! The counter is now 3, which isn't 
less than 3.” 

While: “OK guys. We're done!” 


The program doesn't run the indented code, but moves 


to the single print at the end: ‘We’ll all have tea’. 


For and lists 
The next type of loop is known as 'for'. This is 
designed to work with lists. 

Lists are a type of variable that contain multiple 
items (strings, numbers, or even other variables). 
Create a list by putting items inside square brackets: 


banana splits - ["Bingo", "Fleegle", 
"Drooper", "Snorky"] 


Now enter banana splits in the Shell to view the 
list. It will display the four names inside the square 


brackets. You can access each item individually using 


the variable name and square brackets. Enter: 
banana splits[0] 

...and you'll get “Bingo”. Lists in Python are zero- 

indexed; that means the first item in the list is [0]. 


Here are each of the items. Type them into the Shell 
to get the names returned: 


ty 


| a A, 
m Le 
be 

> 
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name = "Polly" 
counter = 0 


while counter < 3: 
print(name + " put the kettle on") 


counter = counter + 1 


print("We'11 all have tea") 


banana splits[0] & "Bingo" 

banana splits[1] + "Fleegle" 
banana splits[2] + "Drooper" 
banana splits[3] + "Snorky" 


Zero-indexed lists can be confusing at first. Just 
remember that you're counting from o. A for loop 
makes it easy to iterate over items in a list. Create 
this program and save it as splits.py: 


banana splits - ["Bingo", "Fleegle", 
"Drooper", "Snorky"] 


for banana split in banana splits: 
print(banana split) 


It doesn't matter what you use as the variable in 
a for loop, as long as you remember to use it in your 
indented code. You could put: 


for dude in banana splits: 
print(dude) 


It's common to name the list as something plural 
(such as ‘names’, ‘pages’, and ‘items’) and use the 


singular version without the ‘s’ for the ‘in’ variable: 


‘for name in names’, ‘for page in pages’, and so on. 


ES } 


Infinite 
loops 


You must be 
careful to change 
the counter in 

a while loop, 

or you'll get an 
infinite Loop. If 
you delete the 
line counter = 
counter + 1 
from our while 
loop, it will run 
forever: it never 
goes above 0, 

so the indented 
code runs over 
and over again. 
This bug is known 
as an 'infinite 
loop' and is a bad 
thing to have in 
your programs. 
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You can combine 
conditions together 
using logical 
operators. 


and Both operands 
are true: (a and 
b)is True 
Any operator is 
true: (a or b) is 
True 
Checks if 
something is 
false: not (a 
and b) is True 
if both a and b 
are False. 


our programs have been slowly getting more 
powerful. We've learned to run instructions 
in procedural order, replaced parts of our 
program with variables, and looped over the code. 

But another important part of programming is 
called “conditional branching'. Branching is where a 
program decides whether to do something or not. 

Of course, a program doesn't just decide whether or 
not to do things on a whim: we use the sturdy world of 
logic here. 

The start of all this is the powerful “if” statement. 

It looks similar to a loop, but runs just once. The if 
statement asks if a condition is True. If it is, then it 
runs the indented code: 


if True: 
print("Hello World") 


Run this program, and it'll display “Hello World'. 
Now change the if statement to False: 


if False: 
print("Hello World") 


...and nothing will happen. 

Of course, you can't just write True and False. 
Instead, you create a condition which evaluates to 
True or False; a common one is the equals sign (==). 
This checks whether both items on either side are 
the same. Create a new file and enter the code from 
password1.py. This code is a simple program that 
asks you to enter a password; if you enter the correct 
password, ‘qwerty’, it displays ‘Welcome’. 
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Be careful not to confuse the equals logic operator 
zz with the single equals sign =. While the double 
equals sign checks that both sides are the same, 
the single equals sign makes both sides the same. 
Getting == and = mixed up is a common mistake for 
rookie coders. 


What else 

After if, the next conditional branch control you need 
to learn is ‘else’. This command is a companion to if 
and runs as an alternative version. When the if branch 
is True, it runs; when the if branch is False, the else 
branch runs. 


if True: 

print("The first branch ran") 
else: 

print("The second branch ran") 


Run this program and you'll see ‘The first branch 
ran”. But change True to False: 


if False: 

print("The first branch ran") 
else: 

print("The second branch ran") 


...and you'll see “The second branch ran’. Let's use 
this to expand our password program. Enter the code 
from password2.py. 

Run the program again. If you get the password 
correct now, you'll get a welcome message. Otherwise, 
you'll get an “incorrect password’ message. 
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Elif 

The third branching statement you need to know 

is ‘elif’. This statement stands for “else if”, and sits 
between the if and else statements. Let's look at an 
elif statement. Enter this code: 


password - "qwerty" 
attempt - input("Enter password: ") 


if attempt -- password: 
print("Welcome") 


if False: 
print("The first block of code ran") 
elif True: password = "qwerty" 
print("The second block of code ran") attempt = input("Enter password: ") 
else: . 
print("The third block of code ran") if attempt -- password: 
print("Welcome") 
Run this program and you'll find it skips the first if else: i 
statement, but runs the elif statement. You'll get “The print("Incorrect password!") 


second block of code ran'. 
The else statement doesn't have a True or False 


condition; it runs so long as neither the if or elif Writing FizzBuzz 
statements are True. (Note that the else statement here, The brief for our FizzBuzz is to print the numbers from 1 to Comment) 
as always, is optional; you can just have if and elif.) 100. If a number is divisible by three (such as 3, 6, and 9), 

But what happens if you change both the if and elif then you print ‘Fizz’ instead of the number; if the number A mark of a good 
conditions to True? Give it a try and see whether just is divisible by five, you print ‘Buzz’ instead. programmer is to 
if runs, or elif, or both. Experiment with removing the But if a number is divisible by both 3 and 5, such as acomete 
else statement and play around. It'll help you get the the number 15, then you print ‘FizzBuzz’. your programs. 
hang of the if, elif, and else statements. We're also introducing a new element in FizzBuzz: Comments are 

: the “and” statement. This checks if two conditions used to explain 
FizzBuzz are both True: that the number can be divided by bits of your 
We're going to show you a common program used both 3 and 5. It only returns True if both conditions program to 
in computer programming interviews. It's a classic are True. humans. They 
called ‘FizzBuzz’, and it shows that you understand if, There are three main logical operators: and, or, are completely 
else, and elif statements. and not. The first two are relatively straightforward, ignored by 

First, you need to know about the modulo operator but the ‘not’ operator can be more confusing at first. the computer. 
(4). This is used to get the remainder from a division Don't worry about it too much; you'll get the hang of In Python, you 
and is similar to a divide operator. Take this function: it with practice. starta comment 

Enter the fizzbuzz.py code from page 83 to practise Farma 

10 / 4 == 2.5 using if, else, and elif elements and logical operators. symbol (+). It can 


beona line on 


9 po it own, or it can 


If we use a modulo instead, we get this: 


10 % 4 == 2 | an 
soon as Python 


Modulo turns out to be handy in lots of ways. You hits the # it'll 
can use% 2 to figure out if a number is odd or even: 


come right after 
a line of code. As 


stop translating 


whatever follows 
10 % 2 == 0 É this is even 


11 % 2 == 1 # this is odd 


into machine code. 
Comments help 
other users to read 
This program works out if a number is odd or even: your program, but 
they will also help 
you understand 


what you're doing 


number - 10 


if number % 2 == 

print("The number is even") 
else: 

print("The number is odd") 


(long after you've 
forgotten). It's 

a good habit to 
use comments in 


your programs. 


OK - let's move on to FizzBuzz. 
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Create the building blocks of code and make more robust programs 


ou've come a long way since your first 
*Hello World'. Your programs now check 
for conditions and loop over themselves. 

You're now writing programs that are known as 
“Turing complete”, named after Alan Turing, the father 
of computer science and artificial intelligence, who 
hacked the German Enigma code in WWII. 

Now we're going to take things a little further. 
We're going to introduce you to a form of modularity 
called functions. 

Functions are blocks of code that you write once 
and can repeat anywhere. It's a little like being able to 
write a block of text once, and then paste it whenever 
you need it. 


Spotting a function 

Python is packed with built-in functions, 
and you've already been using them in your 
programs. Commands like print(), len(), and 

type() are all functions. They're easy to spot: a 

small command starting with a lower-case letter 
and followed by a pair of parentheses '()'. 


You can browse or download a copy of the Python 
documentation directly from the Python website 


at python.org/doc. Python has a whole bunch of 
built-in functions. You can view a list of all the built-in 
functions on the Python documentation website 
(magpi.cc/2gPsGK3). 
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Using functions 
Let's take a look at a function called abs(). It stands 
for “absolute”, and returns the absolute value of any 
number you pass into it (the bit you pass in is called 
the ‘argument’). 

An absolute number is the positive of any number, so 
if you write abs (-2) you get 2 back. Try this in the Shell: 


abs(2) & returns 2 
abs(-2) # returns 2 


You can store the returned result as a variable: 
positive_number = abs(-10) 


We find it easier to read a function backwards, from 
right to left. The value is passed into the parentheses, 
then the function cranks it and returns a new value. 
This is passed left and stored into the variable. 


Defining a function 

The great thing about Python is that you don't just 
use the built-in functions: you get to make your own. 
These are called “user-defined functions”. 

You create a function using the def keyword, 
followed by the function name and parentheses. 
Inside the parentheses, you list the parameters. 
These are the same as the arguments, only inside the 
definition they are called “parameters”. 


def function(parameter): 
return parameter 
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Tealure 


Our function here doesn't do anything; it simply 
accepts a parameter and returns it. 

At the end of the function definition is a colon (:). 
The function code is indented by four spaces, just like 
a loop or if/else branch. 

The code inside the indentation runs when you call 
the function. Functions typically include a return 
statement which passes back an expression. 


Working functions 
We're going to create a function that prints the lyrics 
to Happy Birthday. 

Type out the happy. birthday.py code from the 
listing, then run it. In the Shell, enter: 


happy. birthday("Lucy") 


This function call uses the string “Lucy? as the 
argument. This string is passed into the function as 
the parameter and is then available for use in the 
indented code inside the function. 


Return statements 
Many functions don't just run a block of code; they 
also return something to the function call. 
We saw this in abs(), which returned the absolute 
value of a number. This can be stored in a variable. 
In fact, we're going to recreate the abs() function, 
so you can see how it's working behind the scenes. 
In maths, you invert a positive/negative value by 
multiplying a negative number by -1, like this: 


10 * -1 = -10 
-10 * -1 - 10 


We need to create a function that takes a number 
as a parameter and checks if it's negative. If so, it 
multiplies it by -1; if it's positive, it simply returns the 
number. We're going to call our function absolute(). 

Enter the code in absolute.py. When the function 
hits either of the return statements, it returns the 
value of the number (either on its own or multiplied 
by -1). It then exits the function. 

Run the absolute.py code and enter the following 
in the Shell: 


absolute(10) 
absolute(-10) 


Our last program listing is a classic known as 
‘FizzBuzz’; as mentioned on page 81, it will help you 
to understand if, else, and elif. 

You also need to know the modulo operator (X) for 
FizzBuzz. This operator returns the remainder from a 
division. If you don't know how modulo works, watch 
this video (magpi.cc/2h5XNRO). 

Now work through the code in fizzbuzz.py. 
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def happy birthday(name): x 
count = 0 happy-birthday.py 
while count < 4: 
if count !- 2: 
print("Happy birthday to you") 
else: 
print("Happy birthday dear " 4 name) 
count += 1 


def absolute(number): 
if number < 0: 
return number * -1 
else: 
return number 


count = 0 
end = 100 fizzbuzz.py 
while count <- end: 
if count % 5 -- 0 and count % 3 -- 0: 
print("FizzBuzz") 
elif count % 3 == 0: 
print("Fizz") 
elif count % 5 == 0: 
print("Buzz") 
else: 
print(count) 


count += 1 


Going further 


Here are some resources you will find useful. 


GPIO Zero Essentials — magpi.cc/2bA3ZP7 

This Essentials guide book explains how the GPIO Zero Python module 
provides access to a bunch of features. These are used to hook up 
electronics to your Raspberry Pi via the GPIO pins. 


FutureLearn - magpi.cc/2h5Sthf 

The Raspberry Pi Foundation has two new online training courses: 
Teaching Physical Computing with Raspberry Pi and Python, and 
Teaching Programming in Primary Schools. 


Learning Python - magpi.cc/2h2opWC 

This tutorial provided by The Raspberry Pi Foundation 
has files you can download. You download the file, 
called intro.py, using this command in a Terminal: 
wget http://goo.gl/0ZDOdX -O intro.py 
--no-check-certificate. Open 

the intro.py file in IDLE; all the 

instructions are in the file. 


LS 


v 
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Importing 


Stand on the shoulders of giants by importing 
other programmers’ code 


Pygame 


If you want to 

learn more about 
Pygame, check out 
Make Games With 
Python, our free 
Essentials Guide to 


the Pygame module. 


magpi.cc/2h2movh 


his being the modern world, you're not 
supposed to do all the work on your 

own. Instead, you will often stand on the 
shoulders of other programmers who have done the 
groundwork for you. 

Your programs can import code created by other 
people using the import statement. This enables 
you to import modules and use their functions - only 
they're now known as “methods”. 

You import the module at the command line, and 
then access the functions using dot notation. This is 
where you list the module, followed by a dot (.), then 
the method. 

A common module to use is math. This allows you 
to access lots of maths methods. Open a Python Shell 
and enter: 


import math 


You now have access to all the methods in math. 
You won't notice any difference, but if you type: 


type(math) 
...it will say ‘<class 'module'>’. Let's try out dot 
notation now. Type math followed by a dot and the 
name of the method (function) you want to use: 

math.sqrt(16) 

This gives the square root of 16, which is 4. 


Some methods have more than one argument. The 
math.pow() method raises a number to an exponent: 
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math.pow(64,3) 


This returns 262144.0. 

You can also access constant values from a module, 
which are fixed variables contained in the module. 
These are like functions/methods, but without 
the parentheses. 


math.pi 


This returns pi to 15 decimal spaces: 
3.141592653589793. 


math.e 


This returns Euler's number to 15 decimal spaces: 
2.718281828459045. 

It’s also possible to import methods and constants 
from modules using from. This enables you to use 
them inside your programs without dot notation 
(like regular functions). For example: 


from math import pi 
from math import e 
from math import pow 


Now, whenever you type pi or e, you'll get pi and 
Euler's number. You can also use pow() just like a 
regular function. You can change the name of the 
function as you import it with as: 


from math import pi as p 


Now when you enter p you'll get pi to 15 decimal 
spaces. Don't go crazy renaming functions with as, 
but it's common to see some methods and constants 
imported as single letters. 

By creating your own functions, and importing 
those created by other people in modules, you can 
vastly improve the capabilities of your programs. 

We're going to take everything we've learnt and use 
it to create a game of Pong; this is one of the world's 
first videogames. 

Write out the code carefully in pong.py. Here you'll 
find variables, functions, loops, and conditional 
branching: all the stuff we've talked about. Hopefully, 
you'll now be able to decipher most of this code. 

If you're interested in taking Pong further, this 
program is similar to a version of a Pygame program 
by Trever Appleton (magpi.cc/2hgkOUX). His version 
has a scorecard and more advanced code. We've kept 
ours simple so it's easier to start with. 

Hopefully this isn't the end of your Python, or 
programming, journey. There are lots of places you 
can learn programming from. And you can find 
more programming resources for you in every issue 
of The MagPi (magpi.cc). 
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import pygame, sys 
from pygame.locals import * 


# Set up game variables 

window width - 400 

window height - 300 

line thickness - 10 

paddle size = 50 # try making this smaller for a harder game 
paddle offset - 20 


# Set up colour variables 
black = (9 ,0 ,0 ) # variables inside brackets are 'tuples' 


white = (255,255,255) # tuples are like lists but the values don't 


change 


# Ball variables (x, y Cartesian coordinates) 

4 Start position middle of horizontal and vertical arena 
ballX - window width/2 - line thickness/2 

ballY - window height/2 - line thickness/2 


# Variables to track ball direction 
ballDirX = -1 ## -1 = left 1 = right 
ballDirY = -1 ## -1 = up 1 = down 


# Starting position in middle of game arena 
playerOnePosition - (window height - paddle size) /2 
playerTwoPosition - (window height - paddle size) /2 


# Create rectangles for ball and paddles 

paddle1 = pygame.Rect(paddle_offset,playerOnePosition, line_ 
thickness, paddle_size) 

paddle2 = pygame.Rect(window_width - paddle_offset - line_ 
thickness, playerTwoPosition, line_thickness, paddle_size) 


ball = pygame.Rect(ballX, ballY, line thickness, line thickness) 


# Function to draw the arena 
def drawArena(): 
screen.fil1((0,0,0)) 
# Draw outline of arena 
pygame.draw.rect(screen, white, ( 
(0,0), (window width,window height)), line thickness*2) 
# Draw centre line 
pygame.draw.line(screen, white, ( 


(int (window width/2)),0), ((int(window width/2)),window height), ( 


int(line thickness/4))) 


# Function to draw the paddles 
def drawPaddle(paddle): 
# Stop the paddle moving too low 
if paddle.bottom » window height - line thickness: 
paddle.bottom - window height- line thickness 
# Stop the paddle moving too high 
elif paddle.top « line thickness: 
paddle.top - line thickness 
# Draws paddle 
pygame.draw.rect(screen, white, paddle) 


& Function to draw the ball 
def drawBall(ball): 
pygame.draw.rect(screen, white, ball) 


& Function to move the ball 

def moveBall(ball, ballDirX, ballDirY): 
ball.x += ballDirX 
ball.y += ballDirY 
return ball & returns new position 


# Function checks for collision with wall and changes ball 
direction 
def checkEdgeCollision(ball, ballDirX, ballDirY): 

if ball.top == (line thickness) or ball.bottom == (window. 


raspberrypi.org/magpi 


73. 


height - line thickness): 
ballDirY = ballDirY * -1 
if ball.left -- (line thickness) or ball. 
right -- (window width - line thickness): 
ballDirX = ballDirX * -1 
return ballDirX, ballDirY # return new direction 


Pong.py 


# Function checks if ball has hit paddle 
def checkHitBall(ball, paddle1, paddle2, ballDirX): 
if ballDirX == -1 and paddle1.right == ball.left and 
paddle1.top < ball.top and paddlel.bottom > ball.bottom: 
return -1 # return new direction (right) 
elif ballDirX == 1 and paddle2.left == ball.right and 
paddle2.top « ball.top and paddle2.bottom » ball.bottom: 
return -1 & return new direction (right) 
else: 
return 1 & return new direction (left) 


# Function for AI of computer player 
def artificialIntelligence(ball, ballDirX, paddle2): 
# Ball is moving away from paddle, move bat to centre 
if ballDirX -- -1: 
if paddle2.centery « (window height/2): 
paddle2.y += 1 
elif paddle2.centery > (window_height/2): 
paddle2.y -= 1 
# Ball moving towards bat, track its movement 
elif ballDirX -- 1: 
if paddle2.centery « ball.centery: 
paddle2.y += 1 
else: 
paddle2.y -=1 
return paddle2 


# Initialise the window 
screen = pygame.display.set_mode((window_width,window_height)) 


pygame.display.set caption( Pong') & Displays in the window 


# Draw the arena and paddles 


. drawArena() 

. drawPaddle(paddle1) 
. drawPaddle(paddle2) 
. drawBall(ball) 


. # Make cursor invisible 
. pygame.mouse.set visible(0) 


. # Main game runs in this loop 
. While True: + infinite loop. Press Ctrl-C to quit game 


for event in pygame.event.get(): 

if event.type -- QUIT: 
pygame.guit() 
sys.exit() 

# Mouse movement 

elif event.type -- MOUSEMOTION: 
mousex, mousey - event.pos 
paddlel.y = mousey 


drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(ball) 


ball = moveBall(ball, ballDirX, ballDirY) 
ballDirX, ballDirY - checkEdgeCollision( 
ball, ballDirX, ballDirY) 
ballDirX = ballDirX " checkHitBall( 
ball, paddle1, paddle2, ballDirX) 
paddle2 = artificialIntelligence (ball, ballDirX, paddle2) 
pygame. display.update() 
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UNDERSTAND OBJECT-ORIENTED PROGRAMMING 


n the modern world, almost all of the 

code you will encounter is created 

in a style called “object-oriented 
programming”, or OOP for short. 

If you grew up with OOP, it is the obvious 
way to create computer programs. 

In OOP, the code is used to create objects. 
These represent real-world things: a dog, a 
chair, or the wheels on a car. 

Objects contain both the variables that 
make that thing: a person's height, age, or 
a name for example. They also contain the 
functions that object can perform: a dog can 
jump, or walk, or run; a wheel can rotate. 

OOP bundles both the variables and 
functions together. This style makes it 
super-easy to cut and paste the code from one 
program to another. You don't even need to cut 
and paste, in fact: you use import statements to 
get functions and the variables they need. 

With OOP, you don't need to create an object for 
a dog: you just find one somebody else has made 
and import it to your program. 


Importing knowledge 
At the start of most programs, you'll find a bunch of 
import statements. These are used to paste in code 
which has been created by other people. 

OOP isn't perfect. It can be accused of overkill. *The 
problem with object-oriented languages is they've got 
all this implicit environment that they carry around 
with them," says Joe Armstrong, creator of Erlang. 
*You wanted a banana but what you got was a gorilla 
holding the banana, and the entire jungle." 

There's also a whole bunch of decorative 
terminology surrounding OOP. You'll encounter 
lots of strange words like ‘encapsulation’ and 
‘instantiation’. These make the concept appear much 
more complicated than it is, and can also be rather 
off-putting to newcomers. 

So OOP is a bit wordy and lends itself to navel- 
gazing. Many makers, hackers, and coders struggle to 
understand OOP, and indeed you can get a long way 
without understanding it. 

Young coders, on the other hand, are increasingly 
introduced to programming via Scratch. 

Software like Scratch is included with Raspbian on 
a Raspberry Pi, and it is designed specifically to teach 
students OOP stealthily. 

In Scratch, objects are called “Sprites”. They 
resemble video game characters. The idea is that 
children brought up on Scratch will inherently 
feel at home with objects when they migrate to a 
language like Python. 
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When you first start programming, you'll begin by 
writing procedural code. 

In good old-fashioned procedural programming, 
you typically create all your variables at the start of a 
program. Then you make some function definitions 
(these are blocks of reusable code). 

We looked at procedural programming in Beginner's 
guide to coding (page 72). 

OOP takes all the building blocks of procedural 
programming - variables, functions, loops, conditions - 
but bundles them into self-contained blocks. 

Most coders create procedural scripts that import 
objects (from modules and packages). So you're using 
objects without even realising it. 

OOP concepts are found in almost all modern 
programming languages, including Python and Java. 
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Createa game in Scratch where players play 
dice with one another 


Raspbian 


Scratch online 


irst, we're going to create a game in 
Scratch. Then we'll recreate it in Python so 
you can see how it works in both languages. 

Our dice game is based on Bunco 
(magpi.cc/2hoZNcj). It's a popular parlour game 
played in North America. 

We've made the rules a little simpler. Each player 
rolls three dice and counts up the score. The player 
with the highest score wins. 

We need two players, each with their own set 
of dice. Each player then rolls the dice, looks at 
their dice, and compares them with the dice of 
the other player. 

If they have the same score, both call it a draw. 
If a player spots that their totalis higher than the 
other person's, they shout out “I win!”. 

This game introduces you to the concept 
of local variables. Each sprite has three local 
variables: their own set of dice. They can also 
look at the variables (or dice) that are local to 
other sprites. 

The opposite of a local variable is a global 
variable. This is as if both players rolled a single set 
of dice and shared the result. They'd always draw. 

Scratch works slightly differently to Python. 

In Scratch, you create one sprite and then clone 
(duplicate) it to create a second sprite. In Python, 
you create a blueprint for your sprites (known as 
a ‘class’) and then stamp out two player objects. 
We'll come to Python in a bit. 

Let's create the dice game in Scratch first... 
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>STEP-01 
Scratch 
Open the web browser and visit scratch.mit.edu to 


open Scratch 2.0. We need the clone features from 
2.0, so don't use the Scratch 1.4 app. Log in (or create 
an account if you're new to Scratch). Create a new 
project and you'll see a single Scratch Cat sprite on the 
screen. Click the ‘i’ symbol next to the sprite in the 
bottom-left. Change its name to Player1. 


>STEP-02 

Three dice 

Click on Data and then Make a Variable. Enter dice1 
in the Variable name field and select “For this sprite 
only”. Click OK and dice1 appears in the blocks 
palette. Repeat the process to create dice2 and dice3. 
Finally, create another variable called total. 
Remember to choose “For this sprite only? for all 
three dice and total. 
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Bunco on Scratch x VW 8 
€ > C| à npa //seratch mit edur 4330/1ed0or 


>STEP-03 

Throw the dice 

Click on Events and drag a when green flag clicked 
block to the scripts area. Below this you need to 

add three set diceN to pick random 1 to 6 blocks. 
Below these blocks, add set total to dice1 + dice2 
+ dice3 (you need to drag one () + () block inside 
another to add up three blocks. 
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>STEP-04 

Speak 

Now drag a say for block and attach it to the end of 
the code. Change it to say total for 1 secs. Below 
that, drag an if block. Inside, add a [] > [] (greater- 
than) block. Drag the total variable to the left side of 
the greater-than block. Drag a say block inside the if 
block and change ‘Hello! to Twin". 
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E 28 9-9] 
(m dem +de + (deed 


raspberrypi.org/magpi 


>STEP-05 

Compare scores 

We’ve only got one sprite so far. But we’re about to 
add another and compare one sprite’s total with the 
other. Choose the Sensing selection of blocks and 
look for one marked x-position of Player1. Change 
‘x-position to total. Drag the block into the correct 


side of the greater-than block. 


pick random @ to O 2 


pore 
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>STEP-06 
Player 2 

Our Player 1 is ready. Now we're going to clone the sprite 
to create a Player 2. Right-click the sprite and choose 
Duplicate. The new cat sprite will be automatically called 
“Player2”. Click on Player1 in the Sprites window. Change 
the total of Player1 block to total of Player2 (as shown 
below). Now Player1 compares their total to Player2 (and 
Player2 is comparing theirs to Player1). Click the green 
flag to run the program and see which player wins. 
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SCOPE 


The concept of scope is important in object-oriented programming. In Scratch, it's 


so simple that you may not even notice it. But our two players each have their own 
dice1, dice2, and dice3 variables, plus a total variable. These variables are local in 
scope. When Player1 announces total, it's their total. If both sprites accessed the 
same total, it would be global in scope. Variables in objects are local in scope. 
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CLASS 
AND INSTANCE 


One of the biggest differences between creating sprites in Scratch and 
objects in Python is that you create an object using a class. This code acts 
as a blueprint for the object. 

In Scratch, you create a sprite and then duplicate it. The second sprite has 
the same functions as the first. It also has its own set of variables. 

In Python (and other programming languages), things work somewhat 


differently. You don't create an object directly. Instead, you create a blueprint 
for the objects. This blueprint is known as the 'class: Don't think of a school, 
though. Class here means a category of similar items. It's rather like a 'Class M' 
planet in Star Trek: though different, these are all Earth-like planets. 

Once you've created your class, you use it to create objects. 


These are known as 'instances' or 'object instances: They all share 
similar properties. They all have the same variables and functions 
(called ‘methods’). In Scratch, we create one sprite and then duplicate 
it (to get two sprites). In Python, we create one class definition. We then 
use this to create two object instances. 
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Recreate our game of Bunco in Python 


ur basic version of Bunco runs just fine in 

Scratch. Now we're going to recreate it in 

Python. The translation will help us get a good 
understanding of how objects work. 

First, think about how we could make the 
game procedurally. 

There is a module called random that we can import 
to create random numbers. So we'd need to import 
that. Then we could create a list for each player. 

And use the randint function to add three random 
numbers between one and six. 

We could then use an if else block with the sum( ) 
function to add up each player's numbers. The player 
with the highest score wins. 

Type out the code from bunco procedural.py to test 
the program. 

There are two problems with this procedural. 
Bunco is a much more complex game in real life. 

It is played in six rounds, and players score 21 points 
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if they roll all three dice that match the number of 


the round (three 1s in round 1, or three 2s in round 2, b ocedural. >PYTHON 
and so on). That's known as rolling a “bunco”. unco pr pu 


We're not going to create all that complexity here. DOWNLOAD: 
But we are going to add extra types of player. Cheats! import random magpi.cc/2jxE6WJ 
One scoundrel has loaded dice; the other rapscallion 
swaps out one die for a six. player1 dice = [] 

We're then going to play thousands of games and player2 dice - [] 
see who wins. 

This complexity would be extremely difficultin for i in range(3): 
procedural programming. It reguires us to rethink our player1 dice.append(random.randint(1,6)) 
approach to Bunco. And OOP is the answer. player2 dice.append(random.randint(1,6)) 


OOPs upside your head print("Player 1 rolled" + str(player1 dice)) 


print("Player 2 rolled" 4 str(player2 dice)) 
Instead of creating a list of variables for each player at 


the start, we're going to create a class called Player. if sum(player1 dice) == sum(player2 dice): 
The code in bunco oop.py represents a dice player. print("Draw") 
We then use it to create two players (see “Class elif sum(player1 dice) > sum(player2 dice): 
and Instance’). print("Player 1 wins") 
As with our procedural code, we start by importing else: 
the randint module. print("Player 2 wins") 


Now we define our player objects. To do this, 
we create a class definition. It looks like this: 


class Player: bunco_oop.py 


Inside the class definition is indented code that from random import randint 
describes the player object. 

Notice that the class name is capitalised and, unlike class Player: 
function definitions, there are no parentheses. def _ init (self): 

The first thing we need to add is a list to contain the self.dice - [] 
dice. Normally this would be just dice = []. But if we 
wrote it like this: def roll(self): 

self.dice = [] + clears current dice 
class Player: for i in range(3): 
dice - [] self.dice.append(randint(1,6)) 

...We'd have a problem. This code is equivalent to def get dice(self): 
choosing “For all sprites? in Scratch. Every player return self.dice 
created using this code would share a single set of 
dice and get the same results. We want to use the player1 = Player() 
equivalent of “For this sprite only'. player2 - Player() 

To ensure that all our players have their own set of 
dice, we need to wrap the dice = [] list inside a quirky player1.rol1() 
function called init (). player2.roll() 

It looks like this: 

print("Player 1 rolled" + str(player1.get dice())) 
class Player: print("Player 2 rolled" + str(player2.get dice())) 
def — init (self): 
self.dice - [] if sum(playerl.get dice()) == sum(player2.get dice()): 
print("Draw!") 

The  init  () function runs when you use a class elif sum(playerl.get dice()) > sum(player2.get dice()): 
to create an object. print("Player 1 wins!") 

This is known as a “constructor” or “initialiser”. else: 

Later on, when we use this Player class to create print("Player 2 wins!") 


player objects, the init () code runs each time 
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automatically. It creates a separate set of dice for each of 
our players. 

The 'self? bit also needs explaining. Variables, like 
our dice = [] list are normally disposed of when a 
function ends (or is returned). 

So if we just put dice = [], the list would be created 
by. init (),then immediately vanish. 

Python gets around this problem using the keyword 
“self”. You put “self” inside the parentheses of the 
. init O: 


def init (self) 


Then we use self, followed by a dot, to store the 
variable in this version of the object. 


self.dice [1 
You then use self. in functions when you want to 
access or change a variable, by writing self inside the 


parentheses of the function. Like this: 
def roll(self): 


The concept can be mind-boggling (it's passing a 
version of itself into itself). So focus on the practical 
steps rather than the esoteric theory of how it works: 


Put a special function at the start of a class called 
. init (self). 


Put the variables you want to use inside init. 


Create the variables with self. , like self.name 
or self.ageor self.dice-[]. 


Place self inside the parentheses of functions that 
need to access the variables. 


Use self. and the name of the variable inside 
the function to use it. 


Got that? Don't worry too much if it seems weird. 
That's the hardest part and it will get easier with practice. 
Now we've got our dice list sorted, what about the 

other functions? 


Methods in the madness 


Now that our class has a list for the dice, we need 
to roll the dice. For that, we'll create a more regular 
function definition. 


def roll(self): 
dice = [] + clears any current dice 
for i in range(3): 
self.dice.append(randint(1,6)) 
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An object's functions are called “methods”, but they 
are created in the same way. 

There are lots of different types of methods, and you 
can create whatever you like, but common ones are 
called ‘setters’ and ‘getters’. 

Our roll method is a “setter”. It sets the dice list to 
three random numbers. 

What do you think a ‘getter’ does? That's right. It 
gets the variables inside the object and returns them. 
We have just the one getter: 


def get dice(self): 
return self.dice 


Getters and setters seem a bit odd at first. After 
all, you could just reach into an object and access 
the variables. 

Well, you could, at least in Python, but this is 
considered a bad thing to do. One of the points of OOP 
is that objects contain their variables and keep them 
safe from other objects. So you don't just reach inside 
an object and access variables. 

Instead, you create methods (functions) that set the 
variables and get them. Then you use these methods 
to set and get variables. 

Now we've created our class definition, we can use it 
to create objects. 


You create objects just as you would a variable. You 
use the assigns operator (=). We're going to create two 
dice players: 


player1 
player2 


Player() 
Player() 


Note that player1 and player2 are not called 
“variables”. They are called “object instances'. 

We access the object instance's methods using dot 
notation. That is where you use the name of the object 
instance, followed by a dot, then the name of the 
method you want to use. 

We created a method, get dice(), that returns 
the dice stored. We would access this method using 
dot notation, such as player1.get_dice(). 

First, we use the roll method to get each player 
object to roll its dice: 


player1.roll() 
player2.roll() 


The rest of our bunco, oop.py program is really 
very similar to bunco procedural.py. The difference 
is that here we use the .get dice() methodin 
place of sum(). 
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NN unco module py 


We've already mentioned that one advantage of OOP 
is that we can create hundreds or thousands of players 
with their own set of variables. 

There's little point in our program as it is, as 
the players are all using the same dice and have the 
same chance of winning. What would happen if we 
introduced some cheats? 

We're going to create a cheat who swaps out one die 
for a six. The blighter. 

Our cheat is not alone. We have another one who 
uses three loaded dice. They always roll one higher 
(unless they're already a six). 

Both cheats would beat a regular player over a few 
hundred games. But which of the cheats would win 
against the other? 

It's pretty close. To find out the answer, we'll 
need to run a simulation that plays hundreds of 
thousands of games. 

We're going to create our cheats using a technique 
called inheritance. This technique is where you create 


But which cheat 
would win against 
the other? 


a class that takes on all the properties (instance 
variables and methods) of another class. It also adds 
a few of its own. 

Think of a child inheriting its parents” features. 

It might get its dad's big nose but grow knobbly knees 
all by itself. 

Our cheats will inherit the same dice and roll 
functions as the parent, but they will have cheat 
functions all of their own. 

Our bunco module.py program defines the 
Player() class and two children: 


class Player: 
class Cheat Swapper(Player): 
class Cheat Loaded Dice(Player): 


Objects that inherit from a parent are defined using 
the same class keyword. 

However, the name of the parent is placed inside 
parentheses of the child. 

Our two cheats inherit all the variables and methods 
(functions) from the parent. So they already have a 
dice list and roll() and get dice() methods. 

We now give each cheat an additional method, 
called cheat. This is implemented in a different way 
for each type of cheat. 
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from random import randint 


class Player: 
def init (self): 
self.dice - [] 


def roll(self): 
self.dice = [] + clears current dice 
for i in range(3): 
self.dice.append(randint(1,6)) 


def get dice(self): 
return self.dice 


class Cheat Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


class Cheat Loaded Dice(Player): 
def cheat(self): 
iz 8 
while i « len(self.dice): 
if self.dice[i] « 6: 
self.dice[i] += 1 
i += 1 


bunco_single_test.py 


from bunco_module import Player 
from bunco_module import Cheat_Swapper 
from bunco_module import Cheat_Loaded_Dice 


cheaterl = Cheat Swapper() 
cheater2 = Cheat Loaded Dice() 


cheater1.roll() 
cheater2.roll() 


cheater1.cheat() 
cheater2.cheat() 


print("Cheater 1 rolled" + str(cheater1.get dice())) 
print("Cheater 2 rolled" 4 str(cheater2.get dice())) 


if sum(cheaterl.get dice()) == sum(cheater2.get dice()): 
print("Draw!") 


elif sum(cheateri.get dice()) > sum(cheater2.get dice()): 
print("Cheater 1 wins!") 


else: 
print("Cheater 2 wins!") 
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The Cheat, Swapper class definition has a relatively 
straightforward cheat method: 


class Cheat Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


Cheat Swapper's cheat method finds the last item 
in the dice list and sets it to 6. 

Our Cheat Loaded Dice class definition has a 
slightly more complicated cheat method: 


class Cheat Loaded Dice(Player): 
def cheat(self): 
i=0 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
Jor 


This method iterates through the dice in the list, 
checking whether each die is lower than six. If so, it 
increases its value by one. 

Make sure that you create the code in 
bunco module.py and save it with the same name. 
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Notice that this code doesn't have any procedural 
programming below it. This is because we're going to 
import it (so you can see what happens when you use 
import in your Python programs). 

Now we will create the code that uses these 
objects in a separate file. Enter the code from the 
bunco single test.py listing and make sure you save 
it in the same directory as bunco module.py. 

The first line imports the Player class definitions 
from our bunco module.py. 


from bunco module import Player 


Extra points to you if you spotted that 
bunco module is listed without the *.py' file 
extension. This is how you import code from other 
files into your program. 

The import Player line pastes in the class Player 
code from bunco module.py. It's as if you had 
included that code in your program. 

Compare this line to the f rom random import 
randint code at the start of bunco module.py. The 
idea is the same. 

We import the other two class definitions 
we created: 
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UNDERSTAND OBJECT-ORIENTED PROGRAMMING 


| bunco_simulation.py 


from bunco_module import Cheat_Swapper 
from bunco_module import Cheat_Loaded_Dice 


The rest of the bunco_single_test.py code creates 
the same game as our earlier bunco_oop.py program. 

Now we create two object instances using the 
Cheat_Swapper and Cheat_Loaded_Dice definitions 
we imported from bunco_module: 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded_Dice() 


We then use the rol1() method. Notice that 
neither Cheat Swapper() or Cheat Loaded Dice() 
has a ro11 method definition. This is a function they 
both inherit from their parent class, Player(): 


cheater1.roll() 
cheater2.roll() 


Next we call the cheat() method from each 
object instance: 


cheater1.cheat() 
cheater2.cheat() 


Although each object has a method called cheat(), 
the objects have different implementations. So 
cheater1 changes the last die to a6, and cheater2 
increases each individual die's value by one. 

Run the program by pressing F5 and see which of 
the players wins. Run it again and you'll get different 
results. Keep running the program and you'll find it's 
a pretty close call. 

Look inside the folder containing the code 
and you'll see a new file has appeared called 
bunco module.pyc. This is a ‘compiled file’ 
and is created the first time you run a program 
that imports code. You don't usually see compiled 
files because you import code tucked away inside 
Python on your computer. Don't worry about it. 

You can't open and make sense of it in a text editor. 
Delete it if you wish. It'll be recreated when you use 
bunco module.py in our final program. You can just 
ignore it for now. 

To discover which of the two cheats has the edge, we 
need to run a simulation. We need to play hundreds 
of thousands of games and keep track of who wins 
the games. 

Our final program, bunco, simulation.py, 
does just that. This program brings together 
everything we've learned about OOP. The code in 
bunco  simulation.py creates two cheats and plays 
100,000 games. It imports class definitions from our 
bunco module.py program (so make sure you save it 
in the same folder). 
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Teature 


from bunco module import * 


swapper = Cheat Swapper() 
loaded dice - Cheat Loaded Dice() 


swapper score = 0 
loaded dice score - 0 


number of games - 100000 
game number = 0 


print("Simulation running") 
print("==================") 
while game_number < number_of_games: 
swapper.roll() 
loaded dice.roll() 


swapper.cheat() 
loaded dice.cheat() 


HRemove # before print statements to see simulation running 
HSimulation takes approximately one hour to run with print 
#statements or ten seconds with print statements 
Hcommented out 


Hprint("Cheater 1 rolled" + str(swapper.get dice())) 
#print("Cheater 2 rolled" + str(loaded dice.get dice())) 


if sum(swapper.get dice()) -- sum(loaded dice.get dice()): 
Hprint("Draw!") 
pass 


elif sum(swapper.get_dice()) > sum(loaded_dice.get_dice()): 
Hprint("Dice swapper wins!") 
swapper score+= 1 
else: 
Hprint("Loaded dice wins!") 
loaded dice score += 1 


game number += 1 


print("Simulation complete") 


print("------------------- ") 
print("Final scores") 
print("------------ či] 


print("Swapper won: 
print("Loaded dice won: 


4 str(swapper score)) 
" 4 str(loaded dice score)) 


if swapper score -- loaded dice score: 
print("Game was drawn") 

elif swapper score » loaded dice score: 
print("Swapper won most games") 

else: 
print("Loaded dice won most games") 
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Use Git version control software to work on your own code 
and contribute to open-source projecis. By Marc Scott 


yo O [El mE 3 X i adas 


mkdir snitch-sniffer 

cd snitch-sniffer/ 
nano README 
ls 


git init 
n /home/pi/snitch-sniffer/ 


pi@raspberrypi: 
README . md 


berrypi: 


description 
HEAD 
i: 


& © OEA O Ppap m 3 TL 49 | sales 


pi@raspberrypi: ~/snitch-sniffer Ai 


GNU nano 2.2.6 File: README.md 


Snitch S 


in three-dimens 
d traject th 


2 © = [>| Q EMporaspuenyo VER » TL 1$) | ° %|1343 
pi@raspberrypi: ~/snitch-sniffer 5 EXE) 


File Edit Tabs Help 


pi@raspberrypi: git commit -am ‘finish find func 
tion' 
[master b1e548e] finish find function 
1 file changed, 1 insertion(+) 
pi@raspberrypi: 


t commit -am ‘add README.md' 
README . md 


This commits all the changes you have made in the 
directory to the Git repo, and adds a message saying 


what you did. The message can be anything really, but 


it's best to keep it fairly short yet descriptive of what 
you changed. 


Time travel 
Now that you have set up your repo, it's time to get on 


with the project. Create two new files and store them in 


your snitch-sniffer directory: 


touch snitch-sniffer.py guidditch-rules.json 


Typing 1s reveals those files. 
README.md  quidditch-rules.json snitch- 
sniffer.py 


The new files need to be added to the Git repo and 
then committed. 


git add --all 


git commit -am 'add json rules and python 
program' 


Carry on working on your code (enter nano 
snitch-sniffer.py and add some dummy code). 
Every time you make a change to the file, perform 
a new commit. 


git commit -am 'finish find function' 


Now imagine that you've made a horrible 
mistake. You've been working for a while, 
and you've deleted your find snitch() function, 
and then performed a commit. With Git, it's easy 
to go back in time and restore an earlier version 
of any of your files. Let's first look at the commit 
history of the file. 


git log snitch-sniffer.py 
This produces something like this: 

commit 
12c4c693e95438ceadcf3f4fb39c83ce1ade712f 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:27:17 2017 40000 

delete find function 
commit 
5fd772a292c019a7cf3012b1156685280d4a7d2d 
Author: Harry Potter <h.potter@hogwarts.prog> 


Date: Fri Mar 3 20:24:52 2017 +0000 


finish find function 
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7251fbd16 aca83cc08d65fc791b1 


commit 78f02fc5de1c8d071746d2db 


commit 
127545c19794b5fe869dd22d0cf57bf8820c5794 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:20:18 2017 +0000 


add json rules and python program 


You can see that the last commit (the one at the 
top) was where the function was deleted. Luckily, 
the commit message has made it easy to see what was 
done, which is why commit messages are important. 
However, typing: 


git log -p snitch-sniffer.py 


... would have shown the changed contents of the 

file if the commit message wasn't clear enough. 
You can now get back the version of the file 

from the previous commit. The long string of 

characters after the word “commit? is called a 

hash, and is used by Git to keep track of files. In 

this case, the commit that needs to be restored is 

5fd772a292c019a7cf3012b1156685280d4a7d2d. 

Typing the following will get the file back to the way 

it was: 


git checkout 
5fd772a292c019a7cf3012b1156685280d4a7d2d 


snitch-sniffer.py 


The file will be restored, and you can now commit 
this change. 


git commit -am 'restore find function' 
Making major changes 


Imagine you're talking to someone about your 
amazing project, and they have a cool idea for some 
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RASPBERRY PI 101: CLONE, COPY AND CONTRIBUTE TO CODE WITH GIT 


You can always check 
the current status of 
your repo 


changes you could make to improve it. They suggest 
using lidar rather than ultrasonic sensors. The 
changes are quite large, though, and you're worried 
that if you make them, you might break the project. 
You could make a copy of the directory and start 
working on this copy, but to keep using Git, you'd 
have to make an entirely new repo. This could all 
get quite confusing. Luckily, Git has a feature called 
branches. Using a branch allows you to make copies 
without losing or altering your original work. 
First, you can have a look at your repo's current status. 


git status 
This should show something like this: 


On branch master 
nothing to commit, working directory clean 


Now you can make a new branch in the repo, which 
lets you work on your amazing new adaptation. 


git checkout -b lidar-version 

Now git status will show you something like this: 
On branch lidar-version 

nothing to commit, working directory clean 
This tells you that you are on the lidar-version branch. 
To view all the branches in your repo, you can type git 


branch, which will show something like this: 


* lidar-version 
master 


You can now work on the lidar-version branch without 
altering your master branch. If you try out the new 
approach and find it doesn't work, you can simply delete 
the branch using git branch -D lidar-version. 
However, if it all works well, you can merge the 
branch back into your master branch. First, you'll 
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need to make sure all your changes are committed and 
then switch back to the master branch. 


git checkout master 


Then you can merge the version into the master 
branch: 


git merge lidar-version 


Warning: you can cause problems with a merge if 
you're working on two branches at the same time, 
as Git won't know which changes are the ones you 
want to keep. For this reason, it's best to work on one 
branch at a time. 


Setting up a Git service 

Now that you know how to do the basics in Git, it is 
time to learn how to use it to its full potential: sharing 
your work and collaborating with others. 

There are lots of services that will host your Git repo 
for you, free of charge. GitLab is one such service, and 
BitBucket is another. In this resource, you are going 
to be using GitHub (github.com), which is one of the 
more popular services. 

The first thing to do is to register for an account on 
GitHub: just choose the free plan. Now that you have 
an account, you can create a snitch-sniffer repo on 
GitHub. Click the New Repository button to the right 
of Your Repositories. Give the repo a name (enter 
snitch-sniffer in the Repository Name field, and a 
short description, such as 3D tracking of objects in 
space" and click Create Repository). This will bring 
up a page of instructions. As you already have a repo 
ready to push to GitHub, all you need to do is make 
sure you are in your project directory in a Terminal 
window, and type: 


git remote add origin https://github.com/ 
harrypotter/scratch-sniffer.git 


...and then: 


Merging puts the changes you have made into your master branch 
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The snitch-sniffer 
repo, showing 
branches, commits, 
and other information 
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E lucyhattersley / scratch-sniffer O Wateh- O Sta O YFork O 
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The Golden Snitch Sniffer. 


This is a project that uses multiple long-range ultrasonic sensors to find and track an object flying in three- 
dimensional space. It displays the object's coordinates, speed, and trajectory through a VR headset. 


© 2017 GitMub, inc. erms Privacy Security Status Help o Contact Gub API Training Shop Blog About 
[oithub.com/lucyhattersiey/scratch-sniffer/branches 


Practise coding for the Sense HAT hardware using the Sense HAT 
emulator built into Raspbian 
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nhumigity.py ome 
Elle Edit Format Bun Options Windows Help 
sense emu SenseHat 


sense = SenseHat() 


green = (0,255,0) 
white = (255.255.255) 


humidity = sense.humidity 


humidity value = 64 * humidity / 100 
pixels = [green if i < humidity value 
sense.set pixels(pixels) 


ressure Humidity Orientation 


« 00° 


Orientation scale © 0" 


180º 


Y Environment sensors 


Simulate 


Inertial measurement unit 


60 


Screen updates 


humidity.py 


sense emu SenseHat 
sense = SenseHat() 


green 
white 


humidity - sense.humidity 

humidity value 64 * humidity 

pixels [green i « humidity value 
white 


sense.set pixels(pixels) 


colorsys 
time 


hues = [(h = 0.01) X 1.0 
pixels = [sv to rgbih, 1.0, 1.0) 
pixels » [(scale(r). scale(g). scale()) 


hat set. pisels(pieels) 
slesp(0:04) 


Ele Ed 


Format Bun Options Windows Help 


colorsys hsv_to_rg> 
tine slee 
sense had Sensekat 

hues = | 
0.00. 0.00, 0.06, 0.13, 0.20. 0.27. 0.24, 0. 
0.00, 0.06, 0.13, 0.21, 0.28, 0.35, 0.42, 0 
0.07, 0.14, 0.21. 0.28. 0.35. 0.42, 0.50, 0 
0.15. 0.22. 0.29. 0.36. 0-43, 0.50, 0.57, 0 
0.22. 0.29. 0.36. 0.44. 0.51, 0.88. 0.65. 0 
0.30, 0.37, 0.44, 0.51, 0.58, 0.66, 0.73, 0 
0.38. 0.45, 0.52. 0.59. 0.66. 0.73. 0.80, 0. 
0.45, 0.52, 0.60. 0.67, 0.74, 0.81. 0.88, 0 
1 

hat = Sensekat() 
scale(v): 

ttv * 255) 

hues = [Ch + 0.01) X 1.0 for h in hues] 
pixels = [hsv to rgb(h. 1.0, 1.0) for h 


pixels = [(scale(r). scale(g). scale(b)) 


| hat.set pixels(pixels) 
| sleep(0-04) 


hues} 


i 


b 


pixels] 


range(64 


)] 


Petite, efficient, and well connected. 
Meet the latest member of the Raspberry Pi family 
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Up close with the technology packed onto a Pi Zero W board 
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We chat with Roger Thornton, principal hardware engineer at the Raspberry Pi Foundation 


01. Ground plane 

This free space is used to 
interact with the radio waves. 
They resonate in this cavity at 
just the right frequency. 


02. Capacitors 

Atthe lower part of the 
ground plane sit two 
capacitors. These capture 
the radio signal. 
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The white text is added to the PCB using a silk-screen technique. 
These markings are used to provide information and branding for the board 


The intelligent layout enables all the 
circuitry to be placed on one side of 
the PCB, keeping the cost down 


A whole new way to hold your Raspberry Pi 


Secure cover 
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Camera cover 
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Five great project ideas for you to build with your new Pi Zero W 


Use a speaker 
and microphone to 
turn your Pi Zero W 

into a hands-free 
Amazon Alexa Echo 
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Free Camera Module connector 
Free USB and HDMI converter cables 
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The world's favourite single-board computer, the Raspberry Pi is packed 
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